Skip to content

Add recommend: one pick and the next step for a need (MCP, WebMCP, REST) - #399

Merged
assafbar2 merged 5 commits into
mainfrom
cursor/recommend-endpoint-4867
Nov 13, 2026
Merged

assafbar2 merged 5 commits into
mainfrom
cursor/recommend-endpoint-4867

Conversation

@assafbar2

Copy link
Copy Markdown
Owner

An agent can now send its user's need in a sentence and get back one pick per need, why it fits, the next step to start using it, and two alternatives. It's offered as:

  • the MCP tool recommend (read-only annotations),
  • the WebMCP tool recommend,
  • GET /api/recommend?need=….

The pick is the Operator's (lib/operator.ts), so there's no model and no per-call cost, and the same need always gets the same answer.

What a reply holds

  • recommendations[]: need, task, pick, pickedBecause, why, unmet, nextStep, alternatives (2), fits.
  • nextStep reuses the connect-bundle logic. It is the MCP config to paste when the vendor's docs give an address or command, else the MCP setup guide, else the vendor's docs.
  • answer: the same in plain sentences, one line per need.
  • stackUrl when there are two or more picks, plus operatorUrl, basis and notes.
  • No need is a 400 no_need. A need no task matches is a 404 no_match that names the closest tasks, rather than returning a weak pick.

Organic results

  • The catalog is read in organic order (organicOrder), and replies pass through withoutPlacement.
  • tests/organic-surfaces.test.ts now runs four recommend calls on both the MCP and WebMCP surfaces against a catalog where half the listings are featured and sponsored. The answers must be identical to the unplaced ones and carry no placement field.

Privacy and crawling

  • The tool description tells agents to write the need themselves and never include names, emails or phone numbers.
  • The route logs only how many picks it made, never the need's text.
  • robots.txt closes /api/recommend to crawlers, since every need is a new URL.

Docs and manifests kept in step: llms.txt, index.md, /for-agents, /connect, the homepage tool lines, skill.md, docs/API.md, README, DISTRIBUTION, the Cursor plugin README, openapi.json, /.well-known/mcp.json and webmcp.json (server version 1.9.0), the MCP smoke script and the e2e machine-endpoint tests.

Not changed: CHANGELOG.md and the package version, so the What's new page is untouched.

Checks run: typecheck, lint, the full test suite (786 tests), content validation, the production build, the Try it link check, and scripts/mcp-smoke.mjs against a local production server (all pass).

Open in Web Open in Cursor 

…and GET /api/recommend

Co-authored-by: assaf.barnir <assaf.barnir@sentry.io>
cursoragent and others added 4 commits November 13, 2026 14:18
…(9 tools), MCP 1.10.0, OpenAPI 1.14.0

Co-authored-by: assaf.barnir <assaf.barnir@sentry.io>
…oint-4867

Co-authored-by: assaf.barnir <assaf.barnir@sentry.io>
Co-authored-by: assaf.barnir <assaf.barnir@sentry.io>
Co-authored-by: assaf.barnir <assaf.barnir@sentry.io>
@assafbar2
assafbar2 merged commit 0b2ae57 into main Nov 13, 2026
1 check passed
cursor Bot pushed a commit that referenced this pull request Nov 13, 2026
Co-authored-by: assaf.barnir <assaf.barnir@sentry.io>
assafbar2 added a commit that referenced this pull request Nov 13, 2026
…earch robots group (#401)

* AEO: answer-first task pages, /tasks/<slug>.md, an agent meta line and a robots group for AI search

Co-authored-by: assaf.barnir <assaf.barnir@sentry.io>

* robots: add the AI search group without touching the * group's rules

Co-authored-by: assaf.barnir <assaf.barnir@sentry.io>

* Merge origin/main into #401 (after #399); release 2.10.4

Co-authored-by: assaf.barnir <assaf.barnir@sentry.io>

---------

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: assaf.barnir <assaf.barnir@sentry.io>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants